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TNTROOUCTION 


Data Comm Audit CDC/ZAUDIT) ts a utility progras written to 
gsonitor RJE» HASP» and NDL tine activity. This audit mechanisa 
is a valuable tool for initiat installation of data coma systems 


and for detection and aonitoring of Line~oritented problemas. 


On the completion of each data coam [0+ the hardtler writes 
information regarding the I0 into a disk file that can be printed 
by DOC/AUDIT. The audit option in RJE» HASP» and NOL may be set 
or reset dynamicatly through the console. For the syntax of the 
audit option in RJE» HASP» and NOL» refer to the MARK V.0+ or. 
higher» documentation of the respective program(s). This 
revisic.: of the 681800/B81700 OC/AUDIT product specification 


supports the MARK VI.0 release of the prograg. 


The audit files, ODOC/AUDIT.FILE» is maintained as a circular disk 
file. When this file gets fitted» the oldest record is 
overuritten with the same new record. This approach optiatzes 
disk space. and at the same tiae allows the user to monitor alt 
data coma I1/0 activity. Furthergores if the data comm handter is 
aborted due to software or hardware aalfunction» a perranent 
record of the last "n" records is stilt available on disk. 


The utitity prograas DC/AUDLT.» aay be executed concurrently with 


the data comm handter and prints records written tnto the audit 
file. The data comm handter and DC/AUDLT maintain 


synchronization through a gailbox (record £01 of the audit file). 


DC/AUDIT accepts several input parameters. By varying these 
input parameterse the printed output @ay be structured so as to 
provide the sost relevent inforaation. 


This product specification describes DC/AUDIT: its operating 
procedures along with the format of the audit file. 


RELATED PUBLICATIONS 


Name | Number 


B1800/B1700 HASP | P.Se 2212 5256 
RJE/TERMINAL CNDL) P.Se2 2212 5249 
RJE/TERMINAL (SDL) PeSe 2212 5231 
B1800/B81700 RJE/DCH P.oSe 2212 5272 
B1800/B81700 NOL (BNF) | | PeSe 2212 5223 
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QDCZAVOLT EILE IMPLEMENTATION 
CREATION OF AUDIT EILE 
When a data coam handler receives a command to start soni toring. 
data coma I/0- the audit file is opened in the following manner: 
OPEN AUDIT INPUT OUTPUT» LOCKs 


ON FILEMISSING <STATEMENT>; — 
ON FILE-LOCKED <STATEMENT>> 


The FILE.-LOCKED condition indicates that the file is inaccessible 


for output hecause another data coma handler has opened it with 


the LOCK option; under this circuagstance the handler witt 
display a aessage and ignore the audit coamand. No two data coma 
handlers may write to the same audit fite at the same tiae. This 
is enforced through the LOCK option of the OPEN statesent. 


The FILE MISSING condition indicates that the file is not 
present. Each data coma handler is then eresponstbte for the 
creation of a new audit file. This is accoaplished with the 
following statements. 7 


OPEN AUDIT INPUT QUTPUT» NEXs 

WRITE AUDIT €0}3 CRECORD)>s 

WRITE AUDIT CLAST] CRECORD)Is % TO UPDATE EOF; 
CLOSE AUDIT LOCK, _ 


The close with LOCK option ensures that the file has been entered 
in the system directory and that it is a permanent file. The 
handler then does another OPEN with the [INPUT >» OUTPUT » LOCK 
option. 


If the OPEN is successful (neither on branch is executed)» then 
the file is locked by the handler. This implies that no other 
handler has write access to it. Howevers OC/AUDIT may still 
access the audit file on a read only basis. If two audit 
sessions are initiated coneurrently» then the two data coma 
handters must access different audit files; this aay be 
accoaptished through file equation. 


Record zero of the audit provides the mailbox between the handler 
and DC/AUDIT. It contains two pointerse START~POINTER and 
NEXT. AVAILABLE.~RECORD. The first points to the oldest recerd in 
the file and the second points to the next available tocatian tn 
the audit file. Record zero atso contains a count of all valid 
records CRECORDS-WRITTEN) in the file. 
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On the first OPEN» the data coma handter initializes 
NEXT.AVAITLAGLE-RECORD and START .POINTER to one and 


~RECORDS-WRITTEN to zero. On subsequent opens» record zero is not 
inttialized. 


The data comm handters have options of opening and closing the 
audit file more than once during a data comm session. In this 
case the START-POINTER wilt be updated so that it wilt stilt 
indicate all records relevant to the current user of the file. 
When the audit file is closed» the fietds in record CO] will 
dalimit ali records which the current user has placed in_ the 
file. : | | 


WRITING IQ IME AUDIT FILE 


When adding records to the audit file» the data comm handler wilt 
write the record to the Location indicated by 
NEXTCAVASCLABLE-RECORD. After each writes or group of writes» the 
data cosa handler will update record €03 by rewriting it with 
NEXT.AVAILASLE.~RECORD and RECORDS.WRITTEN updated. If the number 
of records written has caused the file to cycte (the number of. 
records written is greater than the file size)» the oldest record 
will have been overwritten and the START.POINTER is set equal to 
NEXTeAVAILABLE-RECORD to indicate that the file has cycled. Ina 
cycted file START.POINFER wilt be updated each time the 
NEXT.~AVAILABLE.~RECORD is updated. 


Whan NEXT.AVAILABLE-RECORD is greater than the size of the file, 
the data coaa handler wilt detect an end of file condition when 
attemapting to write the next record. The data comm handler witt 
set NEXT.AVAILABLE-RECORD Cand START.~POINTER if they are equal) 
to one and write the record again. 
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AVOLT DISK EILE 


EILE DECLARAILON 


The audit file is dectared as follows: 


FILE AUDIT 
(LABEL «= "DC"/"AUDIT.FILE"> 
DEVICE = DISK» RANDOM 
RECORDS = 180/ 1+ 


AREAS = 10/100)> 


With the above declaration, the audit file can hold 1C00 records. 
After tue LO0O0th records the next record overwrites the first 
record in the file and the file begins to cycte. On executions 
DC/AUDLT opens the audit file named OC/AUDIT.-FILE as an tinput 


file. 

OPEN AUDIT INPUT? 

ONS FILE.MISSING <STATEMENT>3 
If the file is missing» then it displays an appropriate message 
and terminates. The user may direct DC/AUDIT to read a dif ferent 
audit file through a file equate card. This witt be required in 


the situation where two handlers audit to two different files at 
the same ti@e. | 


RECORD ZERO 


The first record of the filer record (0)» contains pointers that 


describe the state of the file. The format of record (0] ts = as 
follows: 
91 DISK.HEADER CHARACTER (€180)>» 
~~ 02 NEXT.AVYAILABLE-RECORD BIT C024) > 
02 START.POINTER BIT CO2Z4)» 
02 RECORDS-WRITTEN BIT C024)» 


02 FILLER | CHARACTER Ci7 ids 


NEXT-AVAILABLE-RECORD points to the next available Location in 
the audit file. RECORDS.WRITTEN contains the totat number of 
valid records in the audit file. | | 
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OC/AUDIT foreats and prints all records from the START.~POINTER to 
the next pointer. Since the audit file ts cyclical» an end of 
File condition emerely causes DC/AUDIT to initialize its record 


number to one and then to continue printing» up to the next 
record pointer. | 


DC/AUDIT may be run concurrently with the data comm handler. If 
DC/AUDIT catches up with the handlers it waits for "n" Seconcs. 
On being awakened» DC/AUDIT» wilt access record zero to determine 
if there are any records to be printed. If there are no records» 
DC/AUDIY witt wait once again. This allows the system to gain 
controt when DC/AUDIT has no work. Figure 3-1 illustrates the 
audit file cycie. | 
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DATA COMM HANDLER writes DC/AUDIT prints att records 


into this area 
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Figure 3.1 OC/AUDIT Disk File Management 
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10 DESCRIPTOR RECORD CTYPE 1) 


The I0 descriptor record contains one entire I0 descriptors and 
if applicable» its buffer. If there is nat enough rooa for the 
entire buffer» the remaining portion of the buffer will follow in 
continuation records. | | 


Descriptor and their related buffers are written to the file tn 
order they were executed and written onty after they have 
coapleted. 


The format of the I0 descriptor record is as fottows: 


O01 I0.DESCRIPTOR-RECORD> 


o2 TYPE BIT CO04)» % CVALUE IS 1) 

02 HEADER» : 
03 TIMESSTART BIT (€020)>» 
03 TIME.FINISH BIT (020), 
03 PORT BIT (003)> 
03 CHANNEL BIT (004)> 
03 ADAPTER BIT (004)>» 
03 FILLER. BIT (€016)> 
03 DPESCRIPTOR-DATA-ADDRESS BIT (024)> 
03 OISPATCH.BIT BIT (001) 

02 DESCRIPTOR BIT (272 )» 

02 DATAsFIELD» | | 
03 DATA-LENGTH BIT (024). 
03 DATA CHARACTER (C131)3. 

RESERVED WORD MEANING 
TYPE | @arks this record as—i‘(‘i‘it 


[O.DESCRIPTOR.RECORD. 


TIME} START is the time that the descriptor was 
initiated. | 


TIME. FINISH . | is the time that the descriptor is 
: completed. 


Se DESCRIPTOR»DATAs ADDRESS is the absolute address of the Result 
| | Field (RS) of the I0 descriptor. 
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DISPATCH-BIT ff zeros it signifies that the 

| descriptor was dispatched with a 


DC -INITLATE.1O. [If oner it signifies 
that the descriptor was initiated by 
resetting the op-coaplete bit in the RS 


DESCRIPTOR — is actuat I0 descriptor. 

DATA.LENGTH | is the number of bytes in data. 

DATA. - | is the contents of the tuffer. If the 
buffer tength is greater than 131 
bytese it wilt be continued in a 
CONTINUATION record that wilt 
immediately. fottlow this 


| LO.DESCRIPTOR.RECORD.— 
CONTINUATION RECORD CTYPE 2) 
The continuation record contains the continuation of a buffer 
that will not fit in a preceding 10 descriptor record or 
continuation record. A continuation record gust always follow an 
IG descriptor record or another continuation record. 
The forrat of the continuation record is as follows: 


O1 CONTINUATION-RECORD> 


02 = =TYPE BIT €004)e2 X% WALUE IS 2 


92 FILLER BIT (364). 
O2 ODATA-FIELD> 
03 DATA-LENGTH BIT €024)» 
03 DATA | CHARACTER CL31);5 
TYPE | aarks this record as a continuation record. 
~—DATA.~LENGTH is the nuaber of bytes in DATA. 
DATA is the continuation of the buffer fros the 


previous [0 descriptor. 


COMMENT RECORD CTYPE 3) 


A coa@ment record is a record written by the data comm handler to 
provide additional information to the user of the audit file. 
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The format of the record is as follows: 
O01 COMMENT.RECORD> 


02 TYPE | BIT (094) % VALUE IS 3 


02 HEADER> 
03 COMMENT.TIME BIT (€020)>» 
03 FILLER BIT (O072)> 

02 FILLER BIT €272)» 

G2 DATA-FIELD> 
03 DATA.LENGTH BIT (€024)> 
03 DATA CHARACTER €131)>5 

TYPE which has a value of threes marks this record as 


a comment record. 
DATA.LENGSTH is the number of bytes in DATA. 


DATA | is the comment. 


Comment cecords may not have continuation records. 


-. 
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RUN ITDME PARAMETERS 


Upon execution of DC/AUDIT>» the program will took for a disk file. 
labeled “DC/PARAMETERS* which contains the run time paraseters 
for OC/AUDIT. DC/AUDIT witt read this file and process’ the 
parameters. If an error is found in the file» the message: 
"PARAMETER FILE NOT VALIO™ witt be displayed and the fite 
ignoreds requiring manual entry of the run time paraseters. If. 
an exception condition was realized when trying to read the fite 
the message: “PARITY ERROR ON DISK FILE “DC/PARAMETERS*" FILE 
NOT USED" wilt be displayed and the file ignored» requiring 
manual entry of the run time parameters. 


The fiiss tabeled “DC/PARAMETERS™ on disk can be tgnored at 
execute time by setting switch 0 to any value other then zero. 


EXAMPLES= EX DC/AUDIT SW 0 = I> 


The parameter entry» whether from a card reader or conscle 


printer» is free fora. Parameters aust not have isbedded blanks 
and parameters with equal signs aust end with a blank. 


If the file "DC/PARAMETERS"™ is not on disk or the file is in 
error or DC/AUODIT has been instructed to ignore the fite the 
following message wilt be disptayed» indicating the eanual entry 


of run time Parameters to DC/AUDIT. 


"DEFAULT PARAMETERS?” 


The operator can row enter run time parameters or use default run 
time parameters. | 


The following are acceptable response to “DEFAULT PARAMETERS?" : 


<job-nuamber>aXx CPARAMETER LISTI is a list of run tie 


parameter s. 


<job~nuaber>AXEND means alt run time parameters entries froa 
console printer are coaptlete. This message 
may be entered on the same tines as 
CPARAMETER LIST}. 


€job-nuaber >AXR means read the run time parameters from card 


file "CARDS" Labeled “DC/PARAMETERS®. 
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<job-nuaber>AXxVEs means use alt DEFAULT PARAMETERS. 
The error message INVALID PARAMETER DETECTED will be displayed if 


either of the following occur s: 


le PARAMETERS LIST from the console printers, the card reader or 
the disk file eoncangec an invalid parameter. — | 


2. Neither "R", "YES"» "END" nor CPARAMETER LIST] was enterec. 
Following the error messages an additional field indicating the 


last group of characters scanned by OC/AUDIT is atso displayed» 
to assist a user in correcting the error. 


If run tise parameter entry is froa the console printers DC/AUCIT 
will display the foldowing message after validating the previous 
entries? 


ENTER FURTHER PARAMETERS OR "END". 
If run time parameter entry is comptete» the operator enters 
"END®. Otherwiser the operator can enter gore parasfeters. 


NOTES "R™» YES", and "END" must immediately follow the AX when 
responding. 


PARAMETER DEFAULTS AND EQRMATS 
The following is = an atahanetieed list of default run time 


parameterse Specific run time parameters defaults are overriden 


by entry of that parameter in the card file "O9C/PARAMETERS”™ or by 
entry of that parameter list on the console printer. 


PARAMETER and DEFAULT MEANING 


ADDRESS - Print port » channel and adapter that 
10 DESCRIPTOR was dispatched. 


DEFAULT = “ADDRESS* 


ALLeLINES Processes records in the audit file 


from all data comm Lines included fn 


the fi L@e 


DEFAULT: “ALL .«LINES* 
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BUFFERS 


DEF AULT: 


DEL eLINE=CPSCiAe P2CtA» « « o?) 


DEFAULTS 
DISPATCH.BIT 

DEF AULT: 
DOUBLE 

DEFAULT: 


ERROR=(C 102230 OT XXXXXX) 


DEFAULT: 
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Gutput all buffers associated with 
10 descriptor and the continuation 
records. | | 


"BUFFERS® 


While a valid run ti@e parameters 
this is essentialty designed to be 
used while OC/AUDIT its executing. 

The parameter defines specific Lines 
which are not to be audited. DC/AUDTIT 
will delete the entry for the tines 
entered from its list of Lines to be 
audited. 


The format is simitar to the "LINE =" 
parameter below. | 


Alt tines are audited. 


Indicates whether I0 DESCRIPTOR was 
dispatched by the MCP or by resetting 
the complete bit of the 10 DESCRIPTOR. 


"NO.-DEISPATCH" 


Double space each output Line. 


Single. 


If ERROR=1» then output att operations. 


If ERRGR=2> then ignore alt operations 
that completed with exceptions. 


If ERROR=3» then ignore all operations 
that coapleted without exceptions. 


If ERROR=XXXXKK» then use XXXXXXe 
uhich will be the hex respresentation 


of a result descriptors as a @ask toa 
output ontiy the XX XK XX result 
descriptor operations. | 


"ERROR=1" 
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HEADER | 


DEFAULT: 
10-DESC=Cl» 2) 

DEFAULT: 
LENG TH=NNNN 

DEFAULT: 


LINE=C(PSCs Ae PsCtAv..d 


OEF AULT: 
NO. ADDRESS 


DEF AULT: 


NO.B8UFFERS 
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Print a header at the ton of each 
pagee 


Header. 


If 10-DESC=1i» then print the entire 
Id DESCRIPTOR in hex with each field 
separated by blanks. 


If [O.DESC=2- then print just the 
Resutlt Field. The result witl be 
interpreted and printed in English. 


I0.DESC=2. ALi good result descriftcrs 
wilt be printed. 


NNNN is a decimal nuaber 1 to 4 
characters in Length» which indicates 
the maxi@um number of characters in 

a buffer to PE upes 


The entire buf fer wilt be output. 


This parameter defines specific lines 
which are to be audited. P:C2A are the 
port» channet and adapter address of 
each fine. Up to 16 ttnes say be 
entered (P» C and A must be two 
decimals digits in length and coatons 
are required). 


It is not possible to enter att 

Sixteen lines on one parameter recer ds 
consequently» additional Oarameters are 
entered through the “LINE=" option. 

If more than sixteen Lines in total 

are entered into the DC/AUDIT line Liste 
an erro¢e conditton wilt occur. 


Exaaples LINE=07212200» 07:07:00 

Alt lines are audited. 

Suppresses printing of the address to 
which an [/0 descriptor was dispatched. 


"ADDRESS" 


Do not print buffers associated with 


BURROUGHS CORPORATION 
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DEFAULT: 
NO. DISPATCH 

OEF AULT? 
NO. HEADER 

DEF AULT: 
OPS=(1i» 2 OR YYD 

DEFAULT? 


QOUTPUT=CH OR Ad 
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10 DESCRIPTOR 


Print att buffers. | 


Does not print the manrer in which 
a particular [7/0 descriptor was 
dispatched. 


"NO. DISPATCH* 


Do not print header at the top of each 
Nage a 


Header. 


Of OPS=1» then output allt operatior 
codeSe 


If OPS = YY¥e then use the hex mask 
indicated by CYY) to output the 
types of operation code that the 
user wishes to have goritored. 


YY BIT SETTINGS: 


765 4321 0 
RWBTSRRR 
ERRETEEE 
ATES @S 55 
DTATPEEE 
EK R RR 
Vvv 

EEE 

DO 0D 


Example : If the user wishes to display 
read» write and break ops enter “EC%. 


"OPS=1" 

Qutput=H will cause DC/AUDIT to 
display sit buffers with an EBCODIC 
representation of the hexideciaal 


code. | | | : 


Framptes: 20LABa wilt be or inted 
"QLAB®™. | 


Gutput=A will cause DC/AUDIT to print 
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all buffers in alpha format. Att 
graphics ae printed» all special 
characters are printed in EBCOIC 
representation of their hex code. 


Example: 201C102C33503a wilt be 
printed <SOH>ASCO353<ETX> 


DEFAULT: “OQUIPUT=A" 


SINGLE | Single space each output line. 


DEFAULTS Single 


TIME=CkKaenwM? or HH3MM» HHS MM) 
| Time gives a start for the audit 
rune. Any record entered with a time 
less than specified here will be 
ignored. — 


HH>MM represents hours and minutes in 
military representation. 7 


A second time is a stop time. File will 
be audited from first HH24M to seconc 


DEF AULT: ALl the records fros the tast 
sesston are printed. 


DEEAULI PARAMETERS 


The following is the list of run time parageters that will be 
specified if the response to USE DEFAULT? [5 *YES*™. 


ALCLeLINES 
BUFFERS 
ERROR=1 
HEADER 
TO-DESC=2 
NO-ABDRESS 
NO.DISPATCH 
GPS=1 
QUTPUT=A 
SINGLE 


G There will be no indication of how I0 was dispatched or porte 
channel and adapter that I0 was dispatched to. Alt tines and 
buffers witl be output. | 
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PARAMETER Lisl ENTRY 


I f the operator desires to override one or amore of the default 
run tiae parameters» he enters "R* or (CPARAMETER LIST in 
response to “DEFAULT PARAMETERS 2". | | : 


If the entry is through a CPARAMETER LISTI an the oonsote 
printers the operator can enter up to 72 characters containing 


one or more parameters to override the DEFAULT PARAMETERS. A 
parameter entry must be contained wholly in the console printer 


response. Additional entries can be entered after DC/AUDIT | 
displays» . 


ENTER FURTHER PARAMETERS OR “END® 
If entry is through a card reader or a disk file» each card can 


contain «ne or more parameters but each parageter entry must be 
contained wholly on one card or one record. 


The parameter entry» whether from a card reader or console 
printer is free fora. Parameters must not have iabedded blanks 
and parameters with equal signs wust end with a blank. 


If an error ts detected Cinvatid keyword or value) the parameter 
scan is ended and the fottowing error message is displayed: 


INVALID PARAMETER DETECTED 


The operator must re-submit the entire list of parameters again. 


wae 
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OPERATING INSTRUCTIONS 


Upon execution of DOC/AUDIT>» the following aessage witt be 
displayed after the regular systea messages. | 


DEFAULT PARAMETERS? 


Run time parameters are entered at this tine. After verifying 
the parameterse OC/AUDIT will access the audit file. If the 
audit file is not presents DC/AUDIT witt display: 


FILE DC/AUDLT-FILE NOT PRESENT 
and go tc end of job. 


Lf the file is present DC/AUDIT will read record zero and  =<start 
to output the audit file per the run tise parameters. 


I f running in the offline aode> DC/AUDIT will itself go to end of 
joo when it has processed the entire file Cas defined by =record 


zero). When running in the online mode ard no new entries have 


been made to the audit file for a period of one minuter OC/AUDIT 
will interrogate the fite; and tf no cther prograag is using the 
file Can indication that the generating program has gone to EQJ)>» 
DC/AUDIT will itself go to E0J. 


The operator car stop DC/AUDIT or interrogate DC/AUCIT with the 
following cosamands: | 


<job-number>AXxHy causes DC/AUDIT to display a. summary 
accounting of records read and written. 
DC/AUDIT continues to output the audit 
file. 


<job-nuaber>aXTO | causes OC/AUDIT to display att the 
| parameters and their settings under 
which DC/AUDIT ts running. 


<job-nuaber >AXxsST causes DC/AUDIT to print a sumaary 
| accounting of records read and written. 
DC/AUDIT then goes to end of job. 


BURROUGHS CORPORATION 
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<job>AX<PARAMETER LIST> 


| 5-2 
ss COMPANY CONFIDENTIAL 
B1800/81700 DC/AUDIT CREV.D) 
| P.S. 2212 5421. 


causes OC/AUDIT to change its run tia@e 
parameters while processing the audit 
file. The foraat of the parameters are 
the sage as the parameters entered at 
the beginring o f jobs with the 
exception that the TIME parameter witt 
not be accepted. If the new paraseters 
entered are different enough froa those 
previously entered» DC/AUDIT will skip 
to the top of a new page and oprint a 
new page header » if the HcADER 
parameter is set. The LINES= parameter 
when entered wilt add additional lines 
to the list of those checked  oby 
DC/AUDIT. In order to detete lines 
from this list» the ALL-~LINES parameter 
must be first entered and then the new 
tine tist with the LINE= parameter. 
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FILES 
INPUT 


RUN TIME PARAMETER FILE 


CARDS LABELED "DC"™/*PARAMETERS"” 
RECORD SIZE = 80 

BLOCKING 1 RECORD PER SLOCK 
DEVICE IS CARD 


AUDZT FILE 


AUvizi LABELED “DC/AUDIT-FILE" 
RECURD SIZE = 180 

AREAS = 10 | 

BLO@CaS PER AREA = 100 

DEVic& TS RANDOM DISK 


QUIPUT 


© PRINT FILE 


OUT LABELED “DC/PRINT.FILE" 
RECORD SIZE = 132 © 

BLOCKING 1 RECORD PER BLOCK 
DEVICE IS PRINTER OR BACKUP DISK 
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CONSOLE PRINIER MESSAGES 


Console printer messages output by DC/AUDIT are as fottlous in 


alphabetical order: 


DEFAULT PARAMETERS? 


RESPONSE: 


"OC/AUDIT -FILE™ NOT PRESENT 


INVALID MESSAGE TYPE 


RESPONSE: 


INVALID PARAMETER DETECTED 


RESPONSE: 


INVALID RECORD TYPE RECEIVED 


RESPONSE: 


Enter run time parameters. 


Variable. See RUN TIME 
PARAMETERS. 


DC/AUDIT coutd not locate the 
audit file. ODC/AUDIT will now g 
to end of job. : a 


Neither WY» ST» nor a valid 
parameter was entered after 


‘PC/AUDIT processing had started. 


The additional characters printed 
following this message are _ the 
last characters scanned by the 
prograa before the error was. 
encountered. | : 


Enter WY » ST » or. a vatid 
parameter. | | : 


Error was detected while 
analyzing run time parameters. 
The additional characters printed 
following this a@essage are the 
last characters scanned by the 
programa cbefore the error was 
encountered. 


Correct and re~enter parameters. 


4 record was read fros 
DC/AUDIT~FILE with a TYPE value 
not equat to IL» 2» or 36 


DC/AUDIT will dump itself,» print 
a summary report and go to end of 


fob. 


None 
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NO RECORDS PRESENT IN FILE 


RESPONSES 


PARAMETER FILE ON OISK 
NOS VALID 


RESPONSES 


PARITY ERROR ON DISK FILE 
"DC/PARAMETERS”™ FILE NOT USED 


RESPONSES 


UNEXPECTED "EOF" FOUND 
ON AUDET FILE 


RESPONSES: 
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Audit file was empty. DC/AUDIT 
wilt now go to end of jobe © 


None. 


Ihe disk fite “DC/PARAMETERS™ was. 
in error. Run time parageters 


will be entered from card or the 
console printer. The addittonal 
characters printed following this 
message are the Last characters 
scanned by ODOC/AUDIT before the 
error was encountered. 


Enter correct paraseters froa 


card or consote printers or 


correct disk file and re~execute 


OC/AUDTT. 


DC/ AUDIT obtained an error trying 
to read the disk file containing 


the run time parameters. The run 


tige pararweters witt have to be 


entered from card or console 
printer. The additionat 
characters printed following this 
message are the tast characters 


scanned by DC/AUDIT before the 


error was encountered. 


Enter correct parareters froa 
card or console printer, or 
correct the disk file and 
remexecute OC/AUDIT. : 


EQF was returned on read of first 


record in audit file. A summary 
report is printed ard OC/AUDIT 
will go to end of job. | 


None. 


JPSEEREPER Py 


specncsa eases ects RAsCd i bab NGA SRS aj ONL ERG EOE, AICTE NT 
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TYPE2 RECORD OUT OF SEQUENCE 


RESPONSE: 
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A TYPE 2 record does not ollow a 
TYPE 1 record or another TYPE 2 
record. A summary report is 
orinted and DC/AUDIT with go to 
end of job. 


None. 
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QUTPUL FORMATS 


There are four basic output formats with some additional fields 
printed depending on run time parameters setected. The four 
basic formats are: 


Ae Format 1 Result descriptor is interpreted and output 
7 in English. Data written or read from 
operation is printed. i 8 


Be Format 2 Result descriptor is interpreted and output 
| in English. Data written or read _ froa 
operation 1s not printed. | | _ 


C. Forsai 3 Alt fields af the 10 DESCRIPTOR are output in 
 Y hexadecigal representation. Data written or 
read froma operation is printed. 


De. Fora@at 4 All fields of the 10 DESCRIPTOR are output in 
7 ‘7 | hexadecimal representation. Dats written or 
read from operation is not printed. 


With every output forsats» when an I/0 descriptor record is being 
printed» columns 12 thru 18 of the printed Listing wilt be used 
to indicate the type of I[/0 descriptor. There are four basic 
types: "READ">» “"WRITE"%>» "*STOP"™» and “TEST. A nuesber of 
variants are possible. For a read [4/0 descriptor either 
"ROeNTIM"™ (CRead No Time Qut)>s PRDAPOL™ (Read Autopollde | 
"RDeNEOT" (CRead No EOT)I» or "READ® may be printed depending on 
the options set in the I/0 descriptor. For ae write I/0 
descriptors either “"WReAPOL™ (Write Autopoll)» "WRNEGT™ CWrite 
No EQT)» or “HRITE* may be printed. A stop 1/0 descriptor will 
have either *DISCONN™ (Disconnect)» "BREAK® or "STOP" printed. A 
test [70 descriptor witt have "TESTRNG* (Test and Wait for a 
Ringing Phone). "TESTOSR® CTest and wait for "DATA SET READY" doe 
or TEST. | 


NOTES When output formats 1 or 3 are used and the type of I/0 
descriptor is “"WR.APOL">» a “/" wilt be included in the 
data for the operation. | 


A slash indicates the station the operation Con AUTOPOLL) 
coapleted. The address is immediately to the teft of the 
slash. 


If no stash is printedsthe operation coapleted on the tast 
address in the printed data. 
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In cases of a READ or WRITE I/0 descriptor, T aore than one 
variant had been sete onty one will be indicated on the listing. 
The priorities of read and write variants are ttsted below. 


READ  WRETE 
RD.APOL WReNEOT 
RD-NEQT  OWREITE 
READ 


If a siapte “TEST" 1/0 descriptor is processed» an additional 
field willl be printed on the listing namely “"ADAPTER-TD = XX" 
jndicating the type of adapter the descriptor was issued against. 


QUIPUL FORMAT & 


Gutput foergat i is generated when the run time parameter default 
of I0-DESC=2 is specified and NO~BUFFERS has not been specified. 


lf the header parameter is soecified each page witl have the 
following header format: 


seeee 8 1700 DC/AUDIT <DATE TINE> ennes 
TIME OP BUFFER RESULTS 


Records from the audit file witt be output in the _ foraat 
described by Figure 8.1. 


BURROUGHS CORPORATION 


COMPUTER SYSTEM GROUP 
SANTA BARBARA PLANT 


ecto nCe tebe AGS ESS pi St Nene ESP EE AER ay Sg i Aah AR i ve restate woe ts eee eR ERM Lo ao ak RTS iS Sar Eo fdas REI ea Rey Alessi ge vet Lr rh gle Neo PF Br a PSE hn Se aH 


 -B=3 
COMPANY CONFIDENTIAL 


B1800/B1700 DC/AUDIT CREV.0) 


PeSe 2212 5421 


< >» and non-graphics with 
each four bits in hexa- 
decimal representation 


enctosed in € }. Charac- 
ters "€" and "27 wiil 


be treated as non- 


NNO NNZNN AAAAAAA DATA NNSNNSNN 68888 LENGTH=NNNN ccccc 
& ff t es a Length of data §* 
* Op TYPE te If ADDRES * read or written. * 
* | % paraneters t . t 
& this wilt be * = 
[ae « Port» Channel *  f 
For read ops t and Adapter * English inter- 
tige op coa- * that 10 des~ * pretation of 
pleted. Ail * criptor was * abnormal coa- 
other opse & issued to. t pletions. Nor- 
time ops were fe sal coapleticon 
dispatched. : & will be blank. 
& R 
vata written or read. If * 
OUTPUT=A5e data witil consist f 
of graphicse special line t 
ecentrot characters with t 
their names enclosed in 


kkeck&axak 

7 es 

This field wilt appear 

if DISPATCHEO.8IT para- 
meter was specified. If 
10 was initialized by 
resetting the I0 complete 


graphicse EXAMPLE | bite "RESET" wii be 
<STX> CEC] ABCL2 <ETX> printed. If [0 was 
initialized by a dispatch 
com@unicate to the MCP» 
"DISPAITCHED™ wild be 
printed. 


If QUTIPUT=H each four 
bits of data wilt be 
in hexadeciaat repre- 
sentation. 

EXAMPLE 


OLEECIC2CSFIF203 


Figure 8.1 Audit File: Output Format 
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DUIPUT FORMAT 2 


OUTPUT FORMAT 2 generated when default run time paraseter 
I0.-DESC=2 is spectfied and NOQ-BUFFERS is specified. If the 
header parameter is specified each page wilt have the following 
header format: | 


teens B L70G DC/AUDIT <DATE AND TIME> seaee 
TIME op | RESULTS 
Records from the audit file wilt be output in the format 


described by Figure 82-6 


NNSNNSNM AAAAAAA NNSNNSNN BB BBB LENGTH=NNNN CCCCC 


¢ te * & Length of data 
fe Qp TYPE If ADORESS| & read or written. * 
a parageter> i | e 
. this wilt be * « 
Ports» Channel «* | te 
For read op» and Adapter te English tnter- 
time op coa- that [0 des- « pretation of 
pleted. Ait criptor was te abnormal coa- 
other ops» issued to. te pletions. Nor- 
time ops were t mat cospletion 
dispatched. t will be blank. 
x 


® 
This fietd will appear — 
tf DISPATCH.BIT parameter 
was specified. If 10 was 
initiated by resetting the 
10 coaptlete bit "RESET*® witf | 
be printed. [ff I0 was 
initiated by a dispatch 
coaunicate to the MCP, 
"DISPATCH? will be 
printed. | 


Figure 86e2 Audit Files Gutput Format 2 
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QUIPUI EQRMAI 3 
QUIPUT FORMAT 3 generated when run tiee paraseter I0-DESC=1 is 


specified and NO.BUFFERS is specified. If the header parameter 
is specified each page will have the following header format: 


| seeee 8 1700 OC/AUDIT <DATE TIME> sence 
TIME OP BUFFER DESCRIPTOR 


Records from the audit file will be output in the forsat 
described by Figure 6.3. i aes | 


NNZNNENN AAAAA DATA AE=KKKKKK RS=KKAXKK LC ERKKKEK OP =xKKxxx 


ea2eese aa ae on a on SA=KKRMKKX EAR KKKKX MSH KAMK KR KXMKKK 
< | ® 7 * MEMMKK KEK KK KEKKKX K K K LENG TH=nnnn 
& Op TYPE t AO OM OS SO DON SHT HDHD SO DSS ee 
® & fe | 
& Data written or read. Hexadeciaat repr e- 
fe See Figure 8.1 for sentation of I0 
format of data. descriptor. 
& 
For read ape | | AE = Actual Ending Adcress 
tige op coa- | RS = Result Descriptor 
pleted. For oo | ik = Link Address 
all other ops» | OP = Operation 
time op was SA = Start Address 
dispatched. EA = End Address 
| MS = MCP Work Area 


If ADDRESS parameter and/or DISPATCH.BIT 
parameter is specifieds the Ports Chan- 
nel and Adapter and RESET or OISPATCHED 
will precede LCENGTH=nnnne 


LENGTH= is tength of data read or write 
tene ; 


Figure 8.3 Audit File: Cutput Format 3 
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‘QUIPUL FORMAT 4 


OUTPUT FORMAT 4 is generated when run time parameters 10.DESC=1 
and NO.BUFFERS are specified. If the HEADER paraeweter is 
specified each page will have the following header format: 
ae eeee B L700 DC/AUDIT <DATE TIME> «eae 
TIME | op ss DESCRIPTOR 


Records from the audit file wilt be output in the  foraeat 
described in Figure 8.4. | 7 


NN: NNSNN AAAAAAA PPSCC:AA BSBBB LENGTH=NNNN AE=Xxxxxx RS=RXXKKX 


oS Se a= SSS Se CMe. eel eae m2- LK=KKKKKX OP=KXxXxxxx 
fe 7 te & fe Length of SA=KMKXKKM EA=XXXKKX 
il Gp TYPE * t data read HS= 
t SF Or written. ss ster eee eeecece 
& & ® | & 
For read ape t * 
tige op coa- tt & Hexadeciwal value 
pleted. For e * of the IG descrip- 
att other te tt tor. | 
opse tiage op & tt 
was dispatched. & t AE = Actuat Ending Address 
3 t RS = Result Descriptor 
| - te LK = Link Address 
If ADDRESS parameter * OP = Operation 
was defineds this. tt SA = Start Address 
will be Ports, Chan- * EA = End Address 
nel and Adapter te €S = MCP Work Area 
that [0 was issued | 
£06 | & 
| | ts 


This field will appear 
tf DISPATCH.BIT para- 
meter was specified. 
[Tf 10 was initiated 
by resetting the I0 
coaplete bit "RESET? 
will be printed. If 
10 was initiated by a 
: . dispatch communicate 
| : wt 4 to the MCP» “DISPATCHED® 
€ | will be printed. | 


cf. NEN SRE Bean ekg ELE TET AGE PER Res PSE Le bee 
SY EPLURDL EM EPS Be hed SE EIT S aii SECT S rege Pp Ee 


Figure 6-4 Audit File: Output Format 4 
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